package com.ruoyi.system.mapper;

import java.util.List;
import java.util.Map;
import org.apache.ibatis.annotations.Param;
import com.ruoyi.system.domain.CreditUserInfo;

/**
 * 用户信用信息Mapper接口
 * 
 * @author ruoyi
 * @date 2024-01-26
 */
public interface CreditUserInfoMapper 
{
    /**
     * 查询用户信用信息
     * 
     * @param userId 用户信用信息主键
     * @return 用户信用信息
     */
    public CreditUserInfo selectCreditUserInfoByUserId(Long userId);

    /**
     * 查询用户信用信息列表
     * 
     * @param creditUserInfo 用户信用信息
     * @return 用户信用信息集合
     */
    public List<CreditUserInfo> selectCreditUserInfoList(CreditUserInfo creditUserInfo);

    /**
     * 新增用户信用信息
     * 
     * @param creditUserInfo 用户信用信息
     * @return 结果
     */
    public int insertCreditUserInfo(CreditUserInfo creditUserInfo);

    /**
     * 修改用户信用信息
     * 
     * @param creditUserInfo 用户信用信息
     * @return 结果
     */
    public int updateCreditUserInfo(CreditUserInfo creditUserInfo);

    /**
     * 删除用户信用信息
     * 
     * @param userId 用户信用信息主键
     * @return 结果
     */
    public int deleteCreditUserInfoByUserId(Long userId);

    /**
     * 批量删除用户信用信息
     * 
     * @param userIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteCreditUserInfoByUserIds(Long[] userIds);

    /**
     * 根据用户手机号查询用户信用信息
     * 
     * @param phonenumber 手机号
     * @return 用户信用信息
     */
    public CreditUserInfo selectCreditUserInfoByPhonenumber(String phonenumber);

    /**
     * 根据身份证号查询用户信用信息
     * 
     * @param idCard 身份证号
     * @return 用户信用信息
     */
    public CreditUserInfo selectCreditUserInfoByIdCard(String idCard);

    /**
     * 统计总用户数
     * 
     * @return 总用户数
     */
    public int countTotalUsers();

    /**
     * 获取平均信用分
     * 
     * @return 平均信用分
     */
    public Double getAverageCreditScore();

    /**
     * 统计指定信用分区间的用户数量
     * 
     * @param minScore 最小分数
     * @param maxScore 最大分数
     * @return 用户数量
     */
    public int countUsersByScoreRange(@Param("minScore") Integer minScore, @Param("maxScore") Integer maxScore);

    /**
     * 获取信用分排行榜
     * 
     * @param limit 返回数量限制
     * @return 排行榜
     */
    public List<CreditUserInfo> getTopCreditUsers(Integer limit);

    /**
     * 查询用户信用信息（包含基本用户信息）
     * 
     * @param creditUserInfo 查询条件
     * @return 用户信用信息列表
     */
    public List<CreditUserInfo> selectCreditUserInfoWithUserList(CreditUserInfo creditUserInfo);

    /**
     * 统计各省份用户数量和占比
     * @return 省份分布统计
     */
    List<Map<String, Object>> getRegionDistribution();

    /**
     * 获取指定日期范围内的用户登录统计
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 登录统计数据
     */
    List<Map<String, Object>> getLoginStatsByDateRange(@Param("startDate") String startDate, @Param("endDate") String endDate);

    /**
     * 获取指定日期范围内的信用分统计
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 信用分统计数据
     */
    List<Map<String, Object>> getCreditScoreStatsByDateRange(@Param("startDate") String startDate, @Param("endDate") String endDate);

    /**
     * 获取活跃用户数（指定日期范围内有登录记录的用户）
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 活跃用户数
     */
    int getActiveUsersCount(@Param("startDate") String startDate, @Param("endDate") String endDate);

    /**
     * 获取用户增长率
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 用户增长率
     */
    Double getUserGrowthRate(@Param("startDate") String startDate, @Param("endDate") String endDate);

    /**
     * 获取信用分增长率
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 信用分增长率
     */
    Double getCreditScoreGrowthRate(@Param("startDate") String startDate, @Param("endDate") String endDate);

    /**
     * 获取信用分分布统计
     * @return 信用分分布数据
     */
    List<Map<String, Object>> getCreditScoreDistribution();

    /**
     * 获取用户年龄分布统计
     * @return 年龄分布数据
     */
    List<Map<String, Object>> getAgeDistribution();

    /**
     * 获取用户职业分布统计
     * @return 职业分布数据
     */
    List<Map<String, Object>> getOccupationDistribution();

    /**
     * 统计用户总数
     * @return 用户总数
     */
    int selectCreditUserInfoCount();

    /**
     * 查询用户信用分变化历史
     * 
     * @param userId 用户ID
     * @param pageNum 页码
     * @param pageSize 页大小
     * @return 历史记录列表
     */
    List<Map<String, Object>> selectCreditScoreHistory(@Param("userId") Long userId, @Param("pageNum") Integer pageNum, @Param("pageSize") Integer pageSize);

    /**
     * 统计用户信用分变化历史总数
     * 
     * @param userId 用户ID
     * @return 历史记录总数
     */
    int selectCreditScoreHistoryCount(@Param("userId") Long userId);
} 